Single-Page Images

The central element in ImageGear API is the single-page image handle: HIGEAR. The majority of ImageGear API functions take HIGEAR as a parameter. HIGEAR encapsulates the following data:

DIB information, such as dimensions, color space, and channel depths. See DIB Information for more details.
Image pixels (if HIGEAR contains a raster image). Usually, you do not need to access the image pixels directly. You can load, display, process, save images, and do other operations using high-level API that accesses image pixels internally. If you need to access image pixels directly, see Accessing Image Pixels for details.
Image display attributes. See Displaying Images for details.
Image orientation. See Image Orientation for details.
Color profile (optional). See Using Color Profile Manager for details.
Non-rectangular Area of Interest (optional). See Region of Interest Processing for details.
Format-specific information (for DICOM).

Usually you create a HIGEAR handle by loading an image from a disk file, or from memory. See Loading Images for details. You can also create a new HIGEAR handle using IG_image_create, or import a Windows DIB into HIGEAR using IG_image_DIB_import.

When HIGEAR is no longer used, you must delete it using IG_image_delete.

See Also